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1. Inleiding : 

1.1 Pool van de dokumentatie , 

a) Betere communicatie. 

b) Vergemakkelijkt: 

a) het analyseren van programmafouten ; 

b) het inpassen van programmawijzigingen ; 

c) onderhoud aan het programma door anderen dan de oorspronkelijke programmeur. 

c) Dient als geheugensteun . 

d) Dwingt tot systematische aanpak. 

1.2 Criteria voor dokumenteren . 

a) Dokumentatie dient de situatie van het ogenblik weer te geven. 

b) Het maken van de dokumentatie dient vooraf en/of simultaan met het ontwikkelen van de 
toepassing te gebeuren. (Dus niet achteraf.) 

c) Dokumentatie moet betrouwbaar zijn. 

d) Dokumentatie moet goed toegankelijk zijn. 

e) Detail van de toepassing moet begrijpelijk zijn. 

f) Dokumentatie moet niet te bewerkelijk zijn. 

1.3 Algemene regels . 

a) Alle dokumentatie dient te worden vastgelegd op papier formaat kk (210 x 297 mm,). 

b) Blokdiagrammen worden eveneens op A4 formaat getekend. 

c) De dokumentatie dient per blad te zijn voorzien van het programmanummer/naam, hoofdstuk- 
en bladnummer overeenkomstig de inhoudsopgave . 

d) Programmanummers kunnen worden aangevraagd bij de beheerder van de sof tware-bibliotheek. 
Dit is uiteraard alleen noodzakelijk indien U Uw programma in de bibliotheek van de KIM- 
gebruikers club wilt laten opnemen. 

2. Inhoudsopgave van de dokumentatie . 

Hierin wordt vermeld van- tot en met welke bladzijde elk onderdeel van de programmadokumentatie 
is te vinden. 

Te vermelden: 

a) Het.nummer van het hoofdstuk en 

b) de omsohrijving 

c) eerste en laatste bladzijde van het hoofdstuk. 

3. Probleemdef initie . 

Korte omschrijving van het doel en de wijze van werking van dit programma in duidelijke, beknop- 
te, eenvoudige taal. Zinnen kort houden en elk individueel punt opnemen in een nieuwe alinea. 

Opsomming van de in- en uitvoer media en indien van toepassing, waar deze invoer vandaan komt 
en waar de uitvoer naartoe gaat. 
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h. Koofdblokdiagram . 

Het hoofdblokdiagram heeft tot doel een beeld te geven van de verschillende soorten verwer- 
kingen binnen het programma. 

In het hoofdblokdiagram worden geen details vermeld hoe het probleem programmatechnisch is 
opgelost. 

Te gebruiken routines en algemene subroutines alsmede hun in- en uitvoer worden schematisch 
weergegeven. 

5. In- en uitvoer specif ikaties . 

Totaal aantal posities van het record vermelden. 
Op 1 regel te vermelden: 

a) de rubrieknaam (Uit de (6 posities) naam van de rubriek moet met een klein beetje fantasie 

de betekenis van de rubriek blijken); 

b) aantal posities van deze rubriek; 

c) het formaat van de data: 

a) A = Alfabetisch = letters A t/m Z 

b) N = Numeriek = cijfers 0 t/m 9 

c) AN = Alfanumeriek = de letters A t/m Z, de cijfers 0 t/m 9 en alle speciale tekens 

d) CH = character = alle EBCDIC tekens van x'OO' t/m x'FF«. 

e) P = packed decimal. 

f) B = binair 

d) omschrijving van de betekenis van de rubriek en indien van toepassing de inhoud van de 
rubriek en de betekenis van die inhoud (coderingen e.d.); 

Indien gebruik wordt gemaakt van een of meer tabellen, worden deze ook in dit onderdeel van 
de dokumentatie opgenomen. 

Voor printer lay-outs uitsluitend de daarvoor bestemde printer-spacing-charts gebruiken. 
(Tegen vergoeding van de kostprijs te verkrijgen bij de software-bibliotheek). 

6. Ingebouwde controle mogeli jkheden . 

Indien van toepassing moet in ieder programma controles worden ingebouwd zoals tellingen van 
het aantal ingelezen records, tellingen van het aantal wel- en niet verwerkte records, tellin- 
gen van het aantal uitvoer records etc. 

Beschrijving van hoe deze getallen/aantallen te interpreteren. 

7. Algemene subroutines en /of forciules . 

Hierin zijn opgenomen de namen en/of verwijzingen van alle algemene subroutines (ook die van 
de KIM-monitor) die reeds eerder geschreven zijn en in dit programma wederom worden gebruikt. 
Hetzelfde geldt voor algemene formules die reeds eerder zijn beschreven en in dit programma 
worden gehanteerd. 

Nieuv/e, speciaal voor dit programma ontworpen routines, die algemeen bruikbaar zijn, moeten 
apart v/orden gedokumenteerd en niet als onderdeel van dit programma. 

8. Beslissings tabellen . 

Indien in een programma gebruik wordt gemaakt van beslissingstabellen, dient elke beslissings- 
tabel apart in de dokumentatie te worden opgenomen. 
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9. Blokdiagranmen . 

Bij het tekenen van een blokdigram wordt gebruik gemaakt van een "flow-charting "-template. 
(Deze templates zijn tegen vergoeding van de kostprijs te verkrijgen bij de sof twarebiblxotheek 

Blokdigrammen worden evenals de overige dokumentatie getekend op papier formaat Ah. (Speciaal 
papier voor het vervaardigen van blokdiagrammen is tegen vergoeding van de kostprijs te ver- 
krijgen bij de softwarebibliotheek) . 

De "flow" van een blokdiagram is altijd van boven naar beneden en van links naar rechts. Indien 
hiervan raoet worden afgeweken, dienen de verbindingslijnen bij het symbool van ingang te worden 
voorzien van pijlpunten. 

Kruisende lijnen zonder pijlpunten hebben geen logische relatie. Kruisende lijnen met mmstens 
twee tegengestelde pijlpunten nabij het kruispunt hebben een gemeenschappelijke uitgang tussen 
de twee naar elkaar toe wijzende pijlpunten. 

Connectors hebben als funktie het voorkomen van kruisingen van verbindingslijnen en/of het aan- 

geven van de voortzetting van het diagram op dezelfde of een volgende pagina. 

"Onpage"-connectors bevatten het vaknummer waar naartoe of waar vandaan wordt verwezen. 

"Off page "-connectors bevatten het paginanummer en vaknummer waar naartoe of waar vandaan wordt 

verwezen. 

Connectors "waar-naartoe" worden rechts van of onder het symbool geplaatst. 
Connectors "waar vandaan" worden links van of boven het symbool geplaatst. 

Het blokdiagram moet zodanig zijn opgebouwd, dat de "flow" volledig is te volgen en geen vragen 
meer opwerpt. 

10. Lijst van namen van wissels . 

Alle wissels die in programma worden gebruikt, dienen op een aparte lijst in alfabetische 
volgorde te worden vermeld. 

Het gebruik en de funktie van de wissels moet duidelijk worden omschreven. 
1-1. Lijst van namen van werkgebieden . 

Elke programma dokumentatie bevat een lijst van gebruikte werk- en hulpvelden. 
Gebruik en funktie moeten duidelijk zijn. 
Ook deze lijst in alfabetische volgorde. 

12. Boodschappen en codes . 

Voor elk programma dient een lijst aanwezig te zijn van door het programma afgegeven bood- 
schappen, codes en/of geprogrammeerde halts. 

Bij iedere boodschap wordt een verklaring gegeven en eventueel de te ondernemen aktie. 
Boodschappen, codes en/of geprogrammeerde halts uitsluitend zichtbaar maken op de displays 
van de KIM. 

13. Restarts . 

Indien in het programme een restart mogelijk is, moet hier beschreven worden hoe bij abnormale 
bei!indiging van het programma onder de diverse omstandigheden de restart moet plaatsvinden. 

14. Programma listing . 

De programma listing maakt deel uit van de dokumentatie. Alle wijzigingen maken eveneens deel 
uit van de dokumentatie. Er worden nimmer programma listings weggegooid. Zolang een programma 
bestaat blijft alles bev/aard. Indien men een kopie van de dokumentatie vraagt, krijgt men 
echter alleen de laatste versie van de programma listing. 
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FLOWCHART SYMBOLS FOR INFORMATION PROCESSING 



I. SCOPE 

This ISO Recommendation establishes graphical symbols for use in flowcharts for information processing 
systems, including automatic data processing systems. 



2. FIELD OF APPLICATION 

The graphical symbols included in this ISO Recommendation are intended to represent on flowcharts both 

- the sequence of operations and 

- the flow of data and paperwork 

of information processing systems. This ISO Recommendation does not cover : identifying, descriptive or 
explanatory information written inside or adjacent to a symbol; or pictorial type flowcharts that utilize pictures 
or drawings to depict a system. 

3. CONVENTIONS 

3.1 The general direction of flow shall be 

Left to Right 
Top to Bottom 

Arrows indicating the flow shall be used when the flow is not as specified. 
Arrows indicating the flow should be used whenever increased clarity will result. 

3.2 Flow lines may cross; this means they have no logical interrelation. 

3.3 Two or more incoming flow lines may join with one outgoing flow line. 

3.4 While this ISO Recommendation does not make exact specifications about height to width ratios, it 
does require the user not to vary these to such an extent that the symbol is not immediately 
recognizable. 
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process 

This symbol represents any kind of processing functions, 
e.g. the process of executing a defined operation or group 
of operations resulting in a change in value, form, or 
location of information, or in the determination of which 
of several flow directions is to be followed. 



decision 

This symbol represents a decision or switching type 
operation that determines which of a number of 
alternative paths is to be followed 



preparation 

This symbol represents modification of an instruction 
or group of instructions which change the programme 
itself, e.g. set a switch, modify an index register, and 
initialize a routine. 



predefined process 

This symbol represents a named process consisting of 
one or more operations or programme steps that are 
specified elsewhere, e.g. subroutine. 



manual operation 

This symbol represents any offline process geared to 
the speed of a human being, without using mechanical 
aid. 



auxiliary operation 

This symbol represents an offline operation performed 
on equipment not under direct control of the central 
processing unit. 



merge 

This symbol represents the combining of tsvo or more 
sets, of items into one set. 



extract 

This symbol represents the removal of one or more 
specific sets of items from a single set of items. 
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collate 

This symbol represents merging with extracting, 

i.e. the formation of two or more sets of items from two 

or more other sets. 



sort 

- 

This symbol represents the arranging of a set of items into 
a particular sequence. 



manual input 

This symbol represents an input function in which the 
information is entered manually at the time of processing, 
e.g. by means of online keyboards, switch settings, 
push buttons. 



input/output 

This symbol represents an input/output function (I/O), 
i.e. the making available of information for processing 
(input), or the recording of processed information 
(output). 



online storage 

This symbol represents an I/O function utilizing any 
type of online storage, e.g. magnetic tape, magnetic 
drum, magnetic disk. 



offline storage 

This symbol represents the function of storing information 
offline, regardless of the medium on which the information 
is recorded. 



document 

This symbol represents an I/O function in which the 
medium is a document. 



punched card 

This symbol represents an I/O function in which the 
medium is punched card, including mark sense cards, 
partial cards, stub cards, mark scan cards, etc. 
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deck of cards 

This symbol represents a collection of punched cards. 



file of cards 

This symbol represents a collection of related punched 
card records. 



punched tape 

This symbol represents an I/O function in which the 
medium is punched tape. 



magnetic tape 

This symbol represents an I/O function in which the 
medium is magnetic tape. 



magnetic drum 

This symbol represents an I/O function in which the 
medium is magnetic drum. 



magnetic disk 

This symbol represents an I/O function in which the 
medium is magnetic disk. 



core 



This symbol represents an I/O function in which the 
medium is magnetic core. 



display 

This symbol represents an I/O function in which the 
information is displayed for human use at the time of 
processing, by means of online indicators, video devices, 
console printers, plotters, etc. 
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flow line 

(see convention 3.1) 

This symbol represents the function of linking symbols. 



crossing of flow lines 
(see convention 3.2) 

P junction of flow lines 
(see convention 3.3) 



26 parallel mode 

(no flow lines are shown, see convention 3.1) 

This symbol represents the beginning or end of two 
or more simultaneous operations. 



communication link 
(see convention 3.1) 

This symbol represents a function in which informa- 
tion is transmitted by a telecommunication link. 



connector 



This symbol represents an exit to, or an entry from, 
another part of the flowchart. 



terminal, interrupt 

This symbol represents a terminal point in a flowchart, 
e.g. start, stop, halt, delay or interrupt. 



comment, annotation 

This symbol represents the annotation function, 
i.e. the addition of descriptive comments or 
explanatory notes as clarification. 
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